home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr33 / iconmk11.zip / ICONMAKE.ENG < prev    next >
Text File  |  1993-06-12  |  10KB  |  249 lines
  1.                               ICONMAKE 1.1
  2.                     written by Marcus Groeber 1992/93
  3.                             Fido: 2:2402/61.1
  4.  
  5. Iconmake enables you to create your own icons for PC/Geos by converting
  6. existing picture files (PCX and ICO). These icons can be assigned to Dos files
  7. using the GEOS.INI settings; the method is the same as for the built-in icons
  8. and for those from the icon collection by Geoworks themselves.
  9.  
  10. ---
  11. User of ICONMAKE 1.0 should note the paragraph on creating "Tokens from
  12. Geoworks exectuables". It describes how existing icons can be converted for
  13. use with Geoworks 2.0.
  14.  
  15. The batchfile ICONVERT.BAT (read "I convert" :-)) in this archive transfers
  16. entire subdirectories of icons from old (1.x) to new (2.0) format. Usage is:
  17.  
  18.         ICONVERT old_path new_path
  19.  
  20. ICONVERT must be in the current directory for performing this function.
  21. The ICON2TO1.BAT batch file converts icons in the opposite direction (i.e.
  22. GW 2.0 to 1.x).
  23. ---
  24.  
  25.  
  26. The technology
  27. --------------
  28. To "teach" Geoworks new icons, you'll have to create so-called "tokens". These
  29. are references to executable programs or document types, consisting of a
  30. four-letter-code and a number in the range of 0..65535. A token can be
  31. assigned the name of a program, one or more icons (for different screen types)
  32. and sometimes the name of the application that created the document.
  33.  
  34. When a directory is first opened, Geoworks loads the tokens from all
  35. applications that are not yet known into its internal TOKEN.DB database.
  36. Therefore, new tokens can be easily created by using a "dummy" application
  37. that contains not much more than the token itself. By changing into a
  38. directory with such a dummy file, the new icon is automagically installed in
  39. the system.
  40.  
  41.  
  42. The converter
  43. -------------
  44. ICONMAKE enables you to convert icons from PCX (PC Paintbrush) or ICO (Windows
  45. Icons) into such dummy applications, thus giving you access to a huge amount
  46. of graphics.
  47.  
  48. The conversion uses a code fragment from the orignal Geoworks icon collection
  49. (which is probably (c) Geoworks).
  50.  
  51. Important: Geoworks versions 1.x and 2.0
  52. ----------------------------------------
  53. To make this program "future compatible" the default setting for newly created
  54. icons is Geoworks 2.0, i.e. icon files that can only be used with the new
  55. version.
  56.  
  57. To create icons for a 1.x version, you should specify the "/O" (old) option in
  58. second place after the command letter (see below). E.g.
  59.  
  60.         ICONMAKE w /O \geoworks\icons\TEST,12345 test.ICO
  61.  
  62. to convert the Windows icon TEST.ICO into a Geoworks 1.x icon.
  63.  
  64.  
  65. Tokens from PCX files
  66. ---------------------
  67. Each token requires up to three icon files (assume that the token name is
  68. xxxx, names are only examples):
  69.  
  70.   xxxx_CGA.PCX          Low (CGA) resolution: 48x14 pixels, mono
  71.   xxxx_HGC.PCX          High resolution mono (HGC, MCGA): 48x30 Pixel, mono
  72.   xxxx_EGA.PCX          High resolution color (EGA, VGA): 48x30 Pixel, 16 col
  73.  
  74. To create a "dummy" for the token named xxxx (will be called xxxx.000), you
  75. must enter the command
  76.  
  77.         ICONMAKE m xxxx <list of pcx files>
  78. e.g.:   ICONMAKE m icons\TEST,12345 test_cga.pcx test_hgc.pcx test_ega.pcx
  79.  
  80. at the command prompt. You can also specify an additional valued after xxxx
  81. (separated by a ",") to set the numeric component of the token to this value
  82. (default is 255). You could for example use this feature to distinguish
  83. various tokens with the same name in different collections. 
  84.  
  85. In addition, the token name can contain a full pathname that specifies where
  86. the dummy file will be put. An extension will be ignored; the name is always
  87. truncated to 4 characteres. Therefore you can specify the name of the source
  88. file as a suggested icon name in automatic batch runs, and ICONMAKE will
  89. convert it according to its standards. An existing file by the same name will
  90. never be overwritten, instead the program changes the filename to avoid name
  91. conflicts.
  92.  
  93. The filename for the token file is created by taking the token name and adding
  94. the token number (as a hex value). The extension is always "000". 
  95.  
  96. By default, als pixel with color 14 will be displayed as "transparent", i.e.
  97. the background is visible in those places. This color can be changed by
  98. specifying a different value using the "/m" switch after the command letter
  99. "m" (e.g. "/m1"), "/m0" will completely disable transparency. The following
  100. color codes may be used:
  101.  
  102.                   black  1            dark grey  9
  103.                    blue  2           light blue  10
  104.                   green  3          light green  11
  105.                    cyan  4           light cyan  12
  106.                     red  5            light red  13
  107.                 magenta  6        light magenta  14
  108.                   brown  7               yellow  15
  109.              light grey  8                white  16
  110.  
  111.  
  112. Extracting tokens from PC/Geos Files
  113. ------------------------------------
  114. The command
  115.  
  116.         ICONMAKE x <filename> [<target>]
  117.  
  118. extracts icon definitions from existing Geoworks programs (or icon dummys)
  119. into pcx files (the names will follow the example given above). If <target> is
  120. specified, the path (and, if any, four letter file prefix) is used for naming
  121. the PCX files created by this command. When specifying a target pathname only,
  122. it should end in a "\" to be properly recognized.
  123.  
  124.  
  125. Tokens from ICO files
  126. ---------------------
  127. The command
  128.  
  129.         ICONMAKE w xxxx <ICO file>
  130. e.g.:   ICONMAKE w \geoworks\icons\TEST,12345 test.ICO
  131.  
  132. will create a dummy for the token xxxx (naming conventions are the same as for
  133. pcx files) using the graphics in the given Windows icon file. ICONMAKE tries to
  134. get as many different types of icons (CGA, HGC, EGA) from the ICO file, but it
  135. will not attempt to convert a picture that is not available in a "useful"
  136. resultion. Contrary to the Geoworks standard format, the icons created by this
  137. option will usually be of 32x32 size, but this doesn't seem to pose any
  138. problems.
  139.  
  140.  
  141. Tokens from Geoworks executables
  142. --------------------------------
  143. This option extracts a program icon from an exectuable Geoworks program
  144. ("Geode") or "dummy" and creates a "dummy" file containing only the icon. If
  145. necessary, the image is converted between Geoworks 1.x and 2.0 format. Use a
  146. command line like the following
  147.  
  148.         ICONMAKE g xxxx <Geoworks_Datei>
  149. e.g.:   ICONMAKE g \geoworks\icons\test,123 \geoworks\world\draw.geo
  150.  
  151. with xxxx being the name (and path, if required) of the token to be created.
  152. The sample line extracts the icon from the program GeoDraw and puts it into
  153. the icons directory under the token TEST.123. If the name of the token is
  154. omitted, ICONMAKE uses the name of the original token. A path without a token
  155. name must end in a "\" to be recognized properly.
  156.  
  157. Possible uses for this function:
  158.  
  159.  - Converting icons between Geoworks 1.x and 2.0 by reading the icon from
  160. the old file into a new one with the correct format.
  161.  
  162.  - Extracting icons from other programs into separate files for editing.
  163.  
  164.  - Copying existing icons to another token (to keep tokens unique when
  165. editing an icon).
  166.  
  167.  
  168. Argument files
  169. --------------
  170. DOS still limts the length of parameter lines the can be passed to programs to
  171. 126 characters. Therefore, ICONMAKE includes the possibilty to pass command
  172. line arguments using an argument file. Simply include the argument
  173. "@<filename>" in the calling command. The file <filename> can contain as many
  174. parameters as you like, separated by a newline instead of a blank as in the
  175. commandline.
  176.  
  177. In most cases, this will be a list of filenames, e.g.:
  178.  
  179.         ICONMAKE m TEST,123 @FILES.LST
  180.  
  181. with a list of files to be converted in FILES.LST:
  182.  
  183.         test_ega.pcx
  184.         test_hgc.pcx
  185.         test_cga.pcx
  186.  
  187. but you can also use any other combination of parameters and parameter files.
  188.  
  189. This option can also be useful when calling ICONMAKE from your own programs...
  190.  
  191.  
  192. Suggestions:
  193. ------------
  194.  - Once you have installed a token, any changes in the token file will go
  195. unnoticed until you delete your TOKEN.DB in the SYSTEM directory to make
  196. PC/Geos rebuild it. You don't normally loose any information by doing so,
  197. because TOKEN.DB is only a work file that can be recreated from the
  198. applications you have.
  199.  
  200.  - In some paint programs (e.g. Windows Paintbrush) you can avoid color
  201. distortions by loading and re-saving a picture.
  202.  
  203.  - Of course, the fastest way to get LOTS of icons is to take an existing PD
  204. collection for Windows and convert them using a batch command. If the pictures
  205. are packed into an EXE or DLL file, you'll have to use an icon extractor
  206. before starting ICONMAKE (e.g. Daniel Tietze's GETICONS). Most Windows
  207. collections contain only icons for EGA/VGA color resolution.
  208.  
  209.  - The following command line is very useful - it converts all Windows icons
  210. in the current directory into Geoworks icons (names must be different in the
  211. first four characters):
  212.  
  213.         FOR %a IN (*.ICO) DO iconmake w %a,254 %a
  214.  
  215. This command assign the token number 254 to all the icons (this number can of
  216. course be freely chosen).
  217.  
  218.  - To convert all Geoworks 1.x icons from a directory into the new format
  219. you can use the following line:
  220.  
  221.         FOR %a IN (icons1\*.*) DO iconmake g icons2\ %a
  222.  
  223. It creates a new icon "dummy" file in the icons2 directory for every icon
  224. found in the directory named icons1 (which should contain only icons for this
  225. example). Token name and number are duplicated.
  226.  
  227.  - Other programs that can be very useful when working with Geoworks icons:
  228.  
  229.    * ICONED by Thomas Wachsmann is a full-featured icon editor, also
  230.      available in a beta version for Geoworks 1.x.
  231.  
  232.    * TOKENVM by Rudi Ferrari enables you to assign new icons to Geoworks
  233.      documents, e.g. a picture representing the topic of a GeoWrite text.
  234.  
  235.  
  236. Revision history
  237. ================
  238. 1.0
  239.         Initial release
  240.  
  241. 1.01
  242.         Wildcarded filenames and argument files
  243.         PCX import module revised, equivalent to BKGD2PCX 2.2a
  244.  
  245. 1.1
  246.         Support for Geoworks 2.0
  247.         Slightly modified some of the argument formats
  248.         New function to extract/convert icons from Geoworks files
  249.